home *** CD-ROM | disk | FTP | other *** search
/ Mac Mania 4 / MacMania 4.toast / / Tools&Utilities / NoteBooks / inter-cal-12 / Read Me < prev   
Text File  |  1995-07-16  |  6KB  |  95 lines

  1. InterCal 1.2
  2.  
  3. What's New in 1.2
  4. Printing; Julian Easter and Pentecost; French Revolutionary Calendar
  5.  
  6. Introduction
  7.  
  8. This is the second public release of InterCal, a freeware date conversion, calendar comparison, and holiday calculation program. It is not a daily appointment calendar. It displays calendars, one month at a time, for any month of any year in any of several calendar systems. For each day in the displayed month, corresponding dates in another calendar system can be shown. For any selected single day, the corresponding dates in all implemented calendar systems can appear in a separate window.
  9.  
  10. Calendar systems implemented are: Julian, Gregorian, "Western Historical" (a cross between the Julian and Gregorian), Jewish, Islamic, the Elliott Super (invented by the author of InterCal), and the French Revolutionary calendar (the official calendar of France for a few years after the Revolution).
  11.  
  12. Certain religious holydays and festivals are highlighted (under user control) when they occur in a displayed month, regardless of which calendrical system is in use at the time. Some which can be highlighted are Easter, Rosh Hashonah, Hanukah, ‘Id al-Fitr, and the first day of Ramadan.
  13.  
  14.  
  15. Limitations
  16.  
  17. InterCal was designed with 16-inch or larger monitors in mind. But smaller monitors can be used if one is willing to scroll around the display. InterCal exists in a 680x0 version only (no native Power PC version).
  18.  
  19. InterCal requires System 6 or later (it uses pop up menus) and 32-bit QuickDraw. Actually, it will run without 32-bit QuickDraw with some annoying but non-fatal display anomalies.
  20.  
  21. InterCal was developed and tested on a Mac IIci running System 7.1. It has been run and casually tested on several other machines (MacPlus, PowerBook, Centris, Performa, PowerMac) running System 6.0.5, System 7.0.1, System 7.1, and System 7.1.2.
  22.  
  23. Printing has been tested on an NEC Silentwriter™ Model 95 laser printer using both LaserWriter 7 and LaserWriter 8 drivers. It has also been tested on an HP PaintJet™ using the driver provided by HP. It has never been tested on a QuickDraw printer (such as the ImageWriter™).
  24.  
  25.  
  26. Acknowledgements
  27.  
  28. InterCal was developed using Symantec's C++ Version 7.0, Symantec's Visual Architect™, and the Think Class Library. Using those tools shortened development time considerably, but lead to an unexpectedly large size for such a simple program. It requires 700K to run.
  29.  
  30. The InterCal icon was designed and drawn by my 13-year-old daughter Nicole.
  31.  
  32. As described in more detail in "Calendar System Facts", my ability to include the Jewish calendar depended on access to the source code to a freeware program called "Jewish Calendar" written by Frank Yellin.
  33.  
  34. Changes to the format of the Holidays dialog box in Version 1.2 are based on suggestions by Walter Ian Kaye. My apologies to him for not adding the Bahá’í calendar in this version—perhaps in a later one.
  35.  
  36. The rules for the French Revolutionary calendar were given to me by Dave Stewart, Assistant Professor of History at Hillsdale College.
  37.  
  38.  
  39. Package Contents (A folder containing seven items)
  40.  
  41. (1)—This ReadMe file, which was written using SimpleText, not TeachText, and so has some text styling which will not be visible if viewed using TeachText;
  42.  
  43. (2 and 3)—A User's Guide (included for completeness—InterCal is a simple program with very few commands and should be easy to figure out without a manual)—distributed as both a SimpleText document (for general readability) and as a Word™ document (for better formatting and graphics);
  44.  
  45. (4, 5, and 6)—A document entitled "Calendar System Facts" which contains a general discussion of calendars and descriptions of each implemented calendar—also in SimpleText and Word™ format. The SimpleText version had to be split into two parts because SimpleText is limited to rather short documents.
  46.  
  47. (7)—The InterCal application, Version 1.2.
  48.  
  49.  
  50. Legalities
  51.  
  52. Copyright © 1995 by Denis A. Elliott. All rights reserved.
  53.  
  54. No one may distribute InterCal for profit in any form, including (but not limited to) electronic information service distribution, bulletin board distribution, and magnetic or optical medium distribution.  Non-profit distribution of the software is fine, providing that the software is not modified in any way, and the complete works and documentation of the software are included in the distribution package.
  55.  
  56.  
  57. Disclaimer
  58.  
  59. The formulas used in the various calendars and the statements concerning calendars made in "Calendar System Facts" are true to the best of my knowledge. However, their accuracy is not guaranteed.
  60.  
  61.  
  62. Version History
  63.  
  64. Version 1.2—
  65.  
  66.             Added the printing capability;
  67.  
  68.             Changed the appearance and behavior of the Holidays dialog box;
  69.  
  70.             Added Julian Easter and Julian Pentecost to the implemented holidays.
  71.  
  72.             Fixed a bug which sometimes caused an invalid Jewish calendar display—the symptom was months with the wrong number of days, occasionally causing holidays to be displayed in the wrong month. It only happened when the Jewish calendar was the primary, when the date window had been used to change the selected date, and when the change was followed by a "Jump to Selected"  command. Even then, additional special circumstances had to be present or the problem would not appear.
  73.  
  74.             Added a workaround for the problem (discussed in the Known Problems section of the Users' Guide) of truncated popup month and era menus. Since this is not a bug fix I am not sure that the problem is completely gone. I just know it has not been seen on my machine since I made the change. If the problem still occurs in Version 1.2 or any later version, please notify me by e-mail.
  75.  
  76. Version 1.1— (Never publicly released)
  77.             Added the French Revolutionary calendar.
  78.  
  79. Version 1.0—
  80.             Initial release.
  81.  
  82.  
  83. My e-mail address
  84.  
  85. Comments, corrections, bug reports, and suggestions are welcome via e-mail to the following Internet address:
  86.  
  87. denis@alumni.caltech.edu
  88.  
  89.  
  90. Denis Elliott
  91.  
  92.  
  93.  
  94.  
  95.